Inside Macintosh: QuickDraw GX Objects /

Chapter 4 - Colors and Color-Related Objects / Colors and Color-Related Objects Reference

Color Profile Functions / Creating and Manipulating Color Profile Objects

GXCloneColorProfile

You can use the GXCloneColorProfile function to clone a color profile--that is, to add a reference to it and increment its owner count.

gxColorProfile GXCloneColorProfile(gxColorProfile source);

source

A reference to the color profile to clone.

function result

A reference to the cloned color profile.

DESCRIPTION

The GXCloneColorProfile function increments the owner count of the color profile referenced in the source parameter. You typically use this function when you want to create another reference to an existing color profile rather than creating a distinct copy of the color profile.

This function returns as its function result a reference to the color profile--the same reference you pass in as the source parameter. It also increments the color profile's owner count.

SPECIAL CONSIDERATIONS

If you attempt to clone a color profile object used by an onscreen view device, this function posts a colorProfile_access_restricted warning.

ERRORS, WARNINGS, AND NOTICES

Errors
colorProfile_is_nil
Warnings
colorProfile_access_restricted	(debugging version)

SEE ALSO

Owner counts for color profile objects are discussed in the section "Copying, Comparing, and Cloning Color Sets and Color Profiles" beginning on page 4-44, and in the section "Manipulating Owner Counts" beginning on page 4-46.

To examine the owner count of a color profile, use the GXGetColorProfileOwners function, described on page 4-84. To decrement the owner count of a color profile, use the GXDisposeColorProfile function, described on page 4-80.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help